home *** CD-ROM | disk | FTP | other *** search
/ Chip 2007 January, February, March & April / Chip-Cover-CD-2007-02.iso / Pakiet bezpieczenstwa / mini Pentoo LiveCD 2006.1 / mpentoo-2006.1.iso / livecd.squashfs / usr / include / gtk-2.0 / gtk / gtkclist.h < prev    next >
Encoding:
C/C++ Source or Header  |  2006-04-25  |  22.3 KB  |  795 lines
  1. /* GTK - The GIMP Toolkit
  2.  * Copyright (C) 1995-1997 Peter Mattis, Spencer Kimball, Josh MacDonald
  3.  * Copyright (C) 1997-1998 Jay Painter <jpaint@serv.net><jpaint@gimp.org>
  4.  *
  5.  * This library is free software; you can redistribute it and/or
  6.  * modify it under the terms of the GNU Lesser General Public
  7.  * License as published by the Free Software Foundation; either
  8.  * version 2 of the License, or (at your option) any later version.
  9.  *
  10.  * This library is distributed in the hope that it will be useful,
  11.  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  12.  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  13.  * Lesser General Public License for more details.
  14.  *
  15.  * You should have received a copy of the GNU Lesser General Public
  16.  * License along with this library; if not, write to the
  17.  * Free Software Foundation, Inc., 59 Temple Place - Suite 330,
  18.  * Boston, MA 02111-1307, USA.
  19.  */
  20.  
  21. /*
  22.  * Modified by the GTK+ Team and others 1997-2000.  See the AUTHORS
  23.  * file for a list of people on the GTK+ Team.  See the ChangeLog
  24.  * files for a list of changes.  These files are distributed with
  25.  * GTK+ at ftp://ftp.gtk.org/pub/gtk/. 
  26.  */
  27.  
  28. #ifndef GTK_DISABLE_DEPRECATED
  29.  
  30. #ifndef __GTK_CLIST_H__
  31. #define __GTK_CLIST_H__
  32.  
  33. #include <gdk/gdk.h>
  34. #include <gtk/gtksignal.h>
  35. #include <gtk/gtkalignment.h>
  36. #include <gtk/gtklabel.h>
  37. #include <gtk/gtkbutton.h>
  38. #include <gtk/gtkhscrollbar.h>
  39. #include <gtk/gtkvscrollbar.h>
  40. #include <gtk/gtkenums.h>
  41.  
  42.  
  43. G_BEGIN_DECLS
  44.  
  45.  
  46. /* clist flags */
  47. enum {
  48.   GTK_CLIST_IN_DRAG             = 1 <<  0,
  49.   GTK_CLIST_ROW_HEIGHT_SET      = 1 <<  1,
  50.   GTK_CLIST_SHOW_TITLES         = 1 <<  2,
  51.   /* Unused */
  52.   GTK_CLIST_ADD_MODE            = 1 <<  4,
  53.   GTK_CLIST_AUTO_SORT           = 1 <<  5,
  54.   GTK_CLIST_AUTO_RESIZE_BLOCKED = 1 <<  6,
  55.   GTK_CLIST_REORDERABLE         = 1 <<  7,
  56.   GTK_CLIST_USE_DRAG_ICONS      = 1 <<  8,
  57.   GTK_CLIST_DRAW_DRAG_LINE      = 1 <<  9,
  58.   GTK_CLIST_DRAW_DRAG_RECT      = 1 << 10
  59. }; 
  60.  
  61. /* cell types */
  62. typedef enum
  63. {
  64.   GTK_CELL_EMPTY,
  65.   GTK_CELL_TEXT,
  66.   GTK_CELL_PIXMAP,
  67.   GTK_CELL_PIXTEXT,
  68.   GTK_CELL_WIDGET
  69. } GtkCellType;
  70.  
  71. typedef enum
  72. {
  73.   GTK_CLIST_DRAG_NONE,
  74.   GTK_CLIST_DRAG_BEFORE,
  75.   GTK_CLIST_DRAG_INTO,
  76.   GTK_CLIST_DRAG_AFTER
  77. } GtkCListDragPos;
  78.  
  79. typedef enum
  80. {
  81.   GTK_BUTTON_IGNORED = 0,
  82.   GTK_BUTTON_SELECTS = 1 << 0,
  83.   GTK_BUTTON_DRAGS   = 1 << 1,
  84.   GTK_BUTTON_EXPANDS = 1 << 2
  85. } GtkButtonAction;
  86.  
  87. #define GTK_TYPE_CLIST            (gtk_clist_get_type ())
  88. #define GTK_CLIST(obj)            (GTK_CHECK_CAST ((obj), GTK_TYPE_CLIST, GtkCList))
  89. #define GTK_CLIST_CLASS(klass)    (GTK_CHECK_CLASS_CAST ((klass), GTK_TYPE_CLIST, GtkCListClass))
  90. #define GTK_IS_CLIST(obj)         (GTK_CHECK_TYPE ((obj), GTK_TYPE_CLIST))
  91. #define GTK_IS_CLIST_CLASS(klass) (GTK_CHECK_CLASS_TYPE ((klass), GTK_TYPE_CLIST))
  92. #define GTK_CLIST_GET_CLASS(obj)  (GTK_CHECK_GET_CLASS ((obj), GTK_TYPE_CLIST, GtkCListClass))
  93.  
  94.  
  95. #define GTK_CLIST_FLAGS(clist)             (GTK_CLIST (clist)->flags)
  96. #define GTK_CLIST_SET_FLAG(clist,flag)     (GTK_CLIST_FLAGS (clist) |= (GTK_ ## flag))
  97. #define GTK_CLIST_UNSET_FLAG(clist,flag)   (GTK_CLIST_FLAGS (clist) &= ~(GTK_ ## flag))
  98.  
  99. #define GTK_CLIST_IN_DRAG(clist)           (GTK_CLIST_FLAGS (clist) & GTK_CLIST_IN_DRAG)
  100. #define GTK_CLIST_ROW_HEIGHT_SET(clist)    (GTK_CLIST_FLAGS (clist) & GTK_CLIST_ROW_HEIGHT_SET)
  101. #define GTK_CLIST_SHOW_TITLES(clist)       (GTK_CLIST_FLAGS (clist) & GTK_CLIST_SHOW_TITLES)
  102. #define GTK_CLIST_ADD_MODE(clist)          (GTK_CLIST_FLAGS (clist) & GTK_CLIST_ADD_MODE)
  103. #define GTK_CLIST_AUTO_SORT(clist)         (GTK_CLIST_FLAGS (clist) & GTK_CLIST_AUTO_SORT)
  104. #define GTK_CLIST_AUTO_RESIZE_BLOCKED(clist) (GTK_CLIST_FLAGS (clist) & GTK_CLIST_AUTO_RESIZE_BLOCKED)
  105. #define GTK_CLIST_REORDERABLE(clist)       (GTK_CLIST_FLAGS (clist) & GTK_CLIST_REORDERABLE)
  106. #define GTK_CLIST_USE_DRAG_ICONS(clist)    (GTK_CLIST_FLAGS (clist) & GTK_CLIST_USE_DRAG_ICONS)
  107. #define GTK_CLIST_DRAW_DRAG_LINE(clist)    (GTK_CLIST_FLAGS (clist) & GTK_CLIST_DRAW_DRAG_LINE)
  108. #define GTK_CLIST_DRAW_DRAG_RECT(clist)    (GTK_CLIST_FLAGS (clist) & GTK_CLIST_DRAW_DRAG_RECT)
  109.  
  110. #define GTK_CLIST_ROW(_glist_) ((GtkCListRow *)((_glist_)->data))
  111.  
  112. /* pointer casting for cells */
  113. #define GTK_CELL_TEXT(cell)     (((GtkCellText *) &(cell)))
  114. #define GTK_CELL_PIXMAP(cell)   (((GtkCellPixmap *) &(cell)))
  115. #define GTK_CELL_PIXTEXT(cell)  (((GtkCellPixText *) &(cell)))
  116. #define GTK_CELL_WIDGET(cell)   (((GtkCellWidget *) &(cell)))
  117.  
  118. typedef struct _GtkCList GtkCList;
  119. typedef struct _GtkCListClass GtkCListClass;
  120. typedef struct _GtkCListColumn GtkCListColumn;
  121. typedef struct _GtkCListRow GtkCListRow;
  122.  
  123. typedef struct _GtkCell GtkCell;
  124. typedef struct _GtkCellText GtkCellText;
  125. typedef struct _GtkCellPixmap GtkCellPixmap;
  126. typedef struct _GtkCellPixText GtkCellPixText;
  127. typedef struct _GtkCellWidget GtkCellWidget;
  128.  
  129. typedef gint (*GtkCListCompareFunc) (GtkCList     *clist,
  130.                      gconstpointer ptr1,
  131.                      gconstpointer ptr2);
  132.  
  133. typedef struct _GtkCListCellInfo GtkCListCellInfo;
  134. typedef struct _GtkCListDestInfo GtkCListDestInfo;
  135.  
  136. struct _GtkCListCellInfo
  137. {
  138.   gint row;
  139.   gint column;
  140. };
  141.  
  142. struct _GtkCListDestInfo
  143. {
  144.   GtkCListCellInfo cell;
  145.   GtkCListDragPos  insert_pos;
  146. };
  147.  
  148. struct _GtkCList
  149. {
  150.   GtkContainer container;
  151.   
  152.   guint16 flags;
  153.   
  154.   /* mem chunks */
  155.   gpointer row_mem_chunk;
  156.   gpointer cell_mem_chunk;
  157.  
  158.   guint freeze_count;
  159.   
  160.   /* allocation rectangle after the conatiner_border_width
  161.    * and the width of the shadow border */
  162.   GdkRectangle internal_allocation;
  163.   
  164.   /* rows */
  165.   gint rows;
  166.   gint row_height;
  167.   GList *row_list;
  168.   GList *row_list_end;
  169.   
  170.   /* columns */
  171.   gint columns;
  172.   GdkRectangle column_title_area;
  173.   GdkWindow *title_window;
  174.   
  175.   /* dynamicly allocated array of column structures */
  176.   GtkCListColumn *column;
  177.   
  178.   /* the scrolling window and its height and width to
  179.    * make things a little speedier */
  180.   GdkWindow *clist_window;
  181.   gint clist_window_width;
  182.   gint clist_window_height;
  183.   
  184.   /* offsets for scrolling */
  185.   gint hoffset;
  186.   gint voffset;
  187.   
  188.   /* border shadow style */
  189.   GtkShadowType shadow_type;
  190.   
  191.   /* the list's selection mode (gtkenums.h) */
  192.   GtkSelectionMode selection_mode;
  193.   
  194.   /* list of selected rows */
  195.   GList *selection;
  196.   GList *selection_end;
  197.   
  198.   GList *undo_selection;
  199.   GList *undo_unselection;
  200.   gint undo_anchor;
  201.   
  202.   /* mouse buttons */
  203.   guint8 button_actions[5];
  204.  
  205.   guint8 drag_button;
  206.  
  207.   /* dnd */
  208.   GtkCListCellInfo click_cell;
  209.  
  210.   /* scroll adjustments */
  211.   GtkAdjustment *hadjustment;
  212.   GtkAdjustment *vadjustment;
  213.   
  214.   /* xor GC for the vertical drag line */
  215.   GdkGC *xor_gc;
  216.   
  217.   /* gc for drawing unselected cells */
  218.   GdkGC *fg_gc;
  219.   GdkGC *bg_gc;
  220.   
  221.   /* cursor used to indicate dragging */
  222.   GdkCursor *cursor_drag;
  223.   
  224.   /* the current x-pixel location of the xor-drag line */
  225.   gint x_drag;
  226.   
  227.   /* focus handling */
  228.   gint focus_row;
  229.  
  230.   gint focus_header_column;
  231.   
  232.   /* dragging the selection */
  233.   gint anchor;
  234.   GtkStateType anchor_state;
  235.   gint drag_pos;
  236.   gint htimer;
  237.   gint vtimer;
  238.   
  239.   GtkSortType sort_type;
  240.   GtkCListCompareFunc compare;
  241.   gint sort_column;
  242.  
  243.   gint drag_highlight_row;
  244.   GtkCListDragPos drag_highlight_pos;
  245. };
  246.  
  247. struct _GtkCListClass
  248. {
  249.   GtkContainerClass parent_class;
  250.   
  251.   void  (*set_scroll_adjustments) (GtkCList       *clist,
  252.                    GtkAdjustment  *hadjustment,
  253.                    GtkAdjustment  *vadjustment);
  254.   void   (*refresh)             (GtkCList       *clist);
  255.   void   (*select_row)          (GtkCList       *clist,
  256.                  gint            row,
  257.                  gint            column,
  258.                  GdkEvent       *event);
  259.   void   (*unselect_row)        (GtkCList       *clist,
  260.                  gint            row,
  261.                  gint            column,
  262.                  GdkEvent       *event);
  263.   void   (*row_move)            (GtkCList       *clist,
  264.                  gint            source_row,
  265.                  gint            dest_row);
  266.   void   (*click_column)        (GtkCList       *clist,
  267.                  gint            column);
  268.   void   (*resize_column)       (GtkCList       *clist,
  269.                  gint            column,
  270.                                  gint            width);
  271.   void   (*toggle_focus_row)    (GtkCList       *clist);
  272.   void   (*select_all)          (GtkCList       *clist);
  273.   void   (*unselect_all)        (GtkCList       *clist);
  274.   void   (*undo_selection)      (GtkCList       *clist);
  275.   void   (*start_selection)     (GtkCList       *clist);
  276.   void   (*end_selection)       (GtkCList       *clist);
  277.   void   (*extend_selection)    (GtkCList       *clist,
  278.                  GtkScrollType   scroll_type,
  279.                  gfloat          position,
  280.                  gboolean        auto_start_selection);
  281.   void   (*scroll_horizontal)   (GtkCList       *clist,
  282.                  GtkScrollType   scroll_type,
  283.                  gfloat          position);
  284.   void   (*scroll_vertical)     (GtkCList       *clist,
  285.                  GtkScrollType   scroll_type,
  286.                  gfloat          position);
  287.   void   (*toggle_add_mode)     (GtkCList       *clist);
  288.   void   (*abort_column_resize) (GtkCList       *clist);
  289.   void   (*resync_selection)    (GtkCList       *clist,
  290.                  GdkEvent       *event);
  291.   GList* (*selection_find)      (GtkCList       *clist,
  292.                  gint            row_number,
  293.                  GList          *row_list_element);
  294.   void   (*draw_row)            (GtkCList       *clist,
  295.                  GdkRectangle   *area,
  296.                  gint            row,
  297.                  GtkCListRow    *clist_row);
  298.   void   (*draw_drag_highlight) (GtkCList        *clist,
  299.                  GtkCListRow     *target_row,
  300.                  gint             target_row_number,
  301.                  GtkCListDragPos  drag_pos);
  302.   void   (*clear)               (GtkCList       *clist);
  303.   void   (*fake_unselect_all)   (GtkCList       *clist,
  304.                  gint            row);
  305.   void   (*sort_list)           (GtkCList       *clist);
  306.   gint   (*insert_row)          (GtkCList       *clist,
  307.                  gint            row,
  308.                  gchar          *text[]);
  309.   void   (*remove_row)          (GtkCList       *clist,
  310.                  gint            row);
  311.   void   (*set_cell_contents)   (GtkCList       *clist,
  312.                  GtkCListRow    *clist_row,
  313.                  gint            column,
  314.                  GtkCellType     type,
  315.                  const gchar    *text,
  316.                  guint8          spacing,
  317.                  GdkPixmap      *pixmap,
  318.                  GdkBitmap      *mask);
  319.   void   (*cell_size_request)   (GtkCList       *clist,
  320.                  GtkCListRow    *clist_row,
  321.                  gint            column,
  322.                  GtkRequisition *requisition);
  323.  
  324. };
  325.  
  326. struct _GtkCListColumn
  327. {
  328.   gchar *title;
  329.   GdkRectangle area;
  330.   
  331.   GtkWidget *button;
  332.   GdkWindow *window;
  333.   
  334.   gint width;
  335.   gint min_width;
  336.   gint max_width;
  337.   GtkJustification justification;
  338.   
  339.   guint visible        : 1;  
  340.   guint width_set      : 1;
  341.   guint resizeable     : 1;
  342.   guint auto_resize    : 1;
  343.   guint button_passive : 1;
  344. };
  345.  
  346. struct _GtkCListRow
  347. {
  348.   GtkCell *cell;
  349.   GtkStateType state;
  350.   
  351.   GdkColor foreground;
  352.   GdkColor background;
  353.   
  354.   GtkStyle *style;
  355.  
  356.   gpointer data;
  357.   GtkDestroyNotify destroy;
  358.   
  359.   guint fg_set     : 1;
  360.   guint bg_set     : 1;
  361.   guint selectable : 1;
  362. };
  363.  
  364. /* Cell Structures */
  365. struct _GtkCellText
  366. {
  367.   GtkCellType type;
  368.   
  369.   gint16 vertical;
  370.   gint16 horizontal;
  371.   
  372.   GtkStyle *style;
  373.  
  374.   gchar *text;
  375. };
  376.  
  377. struct _GtkCellPixmap
  378. {
  379.   GtkCellType type;
  380.   
  381.   gint16 vertical;
  382.   gint16 horizontal;
  383.   
  384.   GtkStyle *style;
  385.  
  386.   GdkPixmap *pixmap;
  387.   GdkBitmap *mask;
  388. };
  389.  
  390. struct _GtkCellPixText
  391. {
  392.   GtkCellType type;
  393.   
  394.   gint16 vertical;
  395.   gint16 horizontal;
  396.   
  397.   GtkStyle *style;
  398.  
  399.   gchar *text;
  400.   guint8 spacing;
  401.   GdkPixmap *pixmap;
  402.   GdkBitmap *mask;
  403. };
  404.  
  405. struct _GtkCellWidget
  406. {
  407.   GtkCellType type;
  408.   
  409.   gint16 vertical;
  410.   gint16 horizontal;
  411.   
  412.   GtkStyle *style;
  413.  
  414.   GtkWidget *widget;
  415. };
  416.  
  417. struct _GtkCell
  418. {
  419.   GtkCellType type;
  420.   
  421.   gint16 vertical;
  422.   gint16 horizontal;
  423.   
  424.   GtkStyle *style;
  425.  
  426.   union {
  427.     gchar *text;
  428.     
  429.     struct {
  430.       GdkPixmap *pixmap;
  431.       GdkBitmap *mask;
  432.     } pm;
  433.     
  434.     struct {
  435.       gchar *text;
  436.       guint8 spacing;
  437.       GdkPixmap *pixmap;
  438.       GdkBitmap *mask;
  439.     } pt;
  440.     
  441.     GtkWidget *widget;
  442.   } u;
  443. };
  444.  
  445. GtkType gtk_clist_get_type (void) G_GNUC_CONST;
  446.  
  447. /* create a new GtkCList */
  448. GtkWidget* gtk_clist_new             (gint   columns);
  449. GtkWidget* gtk_clist_new_with_titles (gint   columns,
  450.                       gchar *titles[]);
  451.  
  452. /* set adjustments of clist */
  453. void gtk_clist_set_hadjustment (GtkCList      *clist,
  454.                 GtkAdjustment *adjustment);
  455. void gtk_clist_set_vadjustment (GtkCList      *clist,
  456.                 GtkAdjustment *adjustment);
  457.  
  458. /* get adjustments of clist */
  459. GtkAdjustment* gtk_clist_get_hadjustment (GtkCList *clist);
  460. GtkAdjustment* gtk_clist_get_vadjustment (GtkCList *clist);
  461.  
  462. /* set the border style of the clist */
  463. void gtk_clist_set_shadow_type (GtkCList      *clist,
  464.                 GtkShadowType  type);
  465.  
  466. /* set the clist's selection mode */
  467. void gtk_clist_set_selection_mode (GtkCList         *clist,
  468.                    GtkSelectionMode  mode);
  469.  
  470. /* enable clists reorder ability */
  471. void gtk_clist_set_reorderable (GtkCList *clist,
  472.                 gboolean  reorderable);
  473. void gtk_clist_set_use_drag_icons (GtkCList *clist,
  474.                    gboolean  use_icons);
  475. void gtk_clist_set_button_actions (GtkCList *clist,
  476.                    guint     button,
  477.                    guint8    button_actions);
  478.  
  479. /* freeze all visual updates of the list, and then thaw the list after
  480.  * you have made a number of changes and the updates wil occure in a
  481.  * more efficent mannor than if you made them on a unfrozen list
  482.  */
  483. void gtk_clist_freeze (GtkCList *clist);
  484. void gtk_clist_thaw   (GtkCList *clist);
  485.  
  486. /* show and hide the column title buttons */
  487. void gtk_clist_column_titles_show (GtkCList *clist);
  488. void gtk_clist_column_titles_hide (GtkCList *clist);
  489.  
  490. /* set the column title to be a active title (responds to button presses, 
  491.  * prelights, and grabs keyboard focus), or passive where it acts as just
  492.  * a title
  493.  */
  494. void gtk_clist_column_title_active   (GtkCList *clist,
  495.                       gint      column);
  496. void gtk_clist_column_title_passive  (GtkCList *clist,
  497.                       gint      column);
  498. void gtk_clist_column_titles_active  (GtkCList *clist);
  499. void gtk_clist_column_titles_passive (GtkCList *clist);
  500.  
  501. /* set the title in the column title button */
  502. void gtk_clist_set_column_title (GtkCList    *clist,
  503.                  gint         column,
  504.                  const gchar *title);
  505.  
  506. /* returns the title of column. Returns NULL if title is not set */
  507. gchar * gtk_clist_get_column_title (GtkCList *clist,
  508.                     gint      column);
  509.  
  510. /* set a widget instead of a title for the column title button */
  511. void gtk_clist_set_column_widget (GtkCList  *clist,
  512.                   gint       column,
  513.                   GtkWidget *widget);
  514.  
  515. /* returns the column widget */
  516. GtkWidget * gtk_clist_get_column_widget (GtkCList *clist,
  517.                      gint      column);
  518.  
  519. /* set the justification on a column */
  520. void gtk_clist_set_column_justification (GtkCList         *clist,
  521.                      gint              column,
  522.                      GtkJustification  justification);
  523.  
  524. /* set visibility of a column */
  525. void gtk_clist_set_column_visibility (GtkCList *clist,
  526.                       gint      column,
  527.                       gboolean  visible);
  528.  
  529. /* enable/disable column resize operations by mouse */
  530. void gtk_clist_set_column_resizeable (GtkCList *clist,
  531.                       gint      column,
  532.                       gboolean  resizeable);
  533.  
  534. /* resize column automatically to its optimal width */
  535. void gtk_clist_set_column_auto_resize (GtkCList *clist,
  536.                        gint      column,
  537.                        gboolean  auto_resize);
  538.  
  539. gint gtk_clist_columns_autosize (GtkCList *clist);
  540.  
  541. /* return the optimal column width, i.e. maximum of all cell widths */
  542. gint gtk_clist_optimal_column_width (GtkCList *clist,
  543.                      gint      column);
  544.  
  545. /* set the pixel width of a column; this is a necessary step in
  546.  * creating a CList because otherwise the column width is chozen from
  547.  * the width of the column title, which will never be right
  548.  */
  549. void gtk_clist_set_column_width (GtkCList *clist,
  550.                  gint      column,
  551.                  gint      width);
  552.  
  553. /* set column minimum/maximum width. min/max_width < 0 => no restriction */
  554. void gtk_clist_set_column_min_width (GtkCList *clist,
  555.                      gint      column,
  556.                      gint      min_width);
  557. void gtk_clist_set_column_max_width (GtkCList *clist,
  558.                      gint      column,
  559.                      gint      max_width);
  560.  
  561. /* change the height of the rows, the default (height=0) is
  562.  * the hight of the current font.
  563.  */
  564. void gtk_clist_set_row_height (GtkCList *clist,
  565.                    guint     height);
  566.  
  567. /* scroll the viewing area of the list to the given column and row;
  568.  * row_align and col_align are between 0-1 representing the location the
  569.  * row should appear on the screnn, 0.0 being top or left, 1.0 being
  570.  * bottom or right; if row or column is -1 then then there is no change
  571.  */
  572. void gtk_clist_moveto (GtkCList *clist,
  573.                gint      row,
  574.                gint      column,
  575.                gfloat    row_align,
  576.                gfloat    col_align);
  577.  
  578. /* returns whether the row is visible */
  579. GtkVisibility gtk_clist_row_is_visible (GtkCList *clist,
  580.                     gint      row);
  581.  
  582. /* returns the cell type */
  583. GtkCellType gtk_clist_get_cell_type (GtkCList *clist,
  584.                      gint      row,
  585.                      gint      column);
  586.  
  587. /* sets a given cell's text, replacing its current contents */
  588. void gtk_clist_set_text (GtkCList    *clist,
  589.              gint         row,
  590.              gint         column,
  591.              const gchar *text);
  592.  
  593. /* for the "get" functions, any of the return pointer can be
  594.  * NULL if you are not interested
  595.  */
  596. gint gtk_clist_get_text (GtkCList  *clist,
  597.              gint       row,
  598.              gint       column,
  599.              gchar    **text);
  600.  
  601. /* sets a given cell's pixmap, replacing its current contents */
  602. void gtk_clist_set_pixmap (GtkCList  *clist,
  603.                gint       row,
  604.                gint       column,
  605.                GdkPixmap *pixmap,
  606.                GdkBitmap *mask);
  607.  
  608. gint gtk_clist_get_pixmap (GtkCList   *clist,
  609.                gint        row,
  610.                gint        column,
  611.                GdkPixmap **pixmap,
  612.                GdkBitmap **mask);
  613.  
  614. /* sets a given cell's pixmap and text, replacing its current contents */
  615. void gtk_clist_set_pixtext (GtkCList    *clist,
  616.                 gint         row,
  617.                 gint         column,
  618.                 const gchar *text,
  619.                 guint8       spacing,
  620.                 GdkPixmap   *pixmap,
  621.                 GdkBitmap   *mask);
  622.  
  623. gint gtk_clist_get_pixtext (GtkCList   *clist,
  624.                 gint        row,
  625.                 gint        column,
  626.                 gchar     **text,
  627.                 guint8     *spacing,
  628.                 GdkPixmap **pixmap,
  629.                 GdkBitmap **mask);
  630.  
  631. /* sets the foreground color of a row, the color must already
  632.  * be allocated
  633.  */
  634. void gtk_clist_set_foreground (GtkCList       *clist,
  635.                    gint            row,
  636.                    const GdkColor *color);
  637.  
  638. /* sets the background color of a row, the color must already
  639.  * be allocated
  640.  */
  641. void gtk_clist_set_background (GtkCList       *clist,
  642.                    gint            row,
  643.                    const GdkColor *color);
  644.  
  645. /* set / get cell styles */
  646. void gtk_clist_set_cell_style (GtkCList *clist,
  647.                    gint      row,
  648.                    gint      column,
  649.                    GtkStyle *style);
  650.  
  651. GtkStyle *gtk_clist_get_cell_style (GtkCList *clist,
  652.                     gint      row,
  653.                     gint      column);
  654.  
  655. void gtk_clist_set_row_style (GtkCList *clist,
  656.                   gint      row,
  657.                   GtkStyle *style);
  658.  
  659. GtkStyle *gtk_clist_get_row_style (GtkCList *clist,
  660.                    gint      row);
  661.  
  662. /* this sets a horizontal and vertical shift for drawing
  663.  * the contents of a cell; it can be positive or negitive;
  664.  * this is particulary useful for indenting items in a column
  665.  */
  666. void gtk_clist_set_shift (GtkCList *clist,
  667.               gint      row,
  668.               gint      column,
  669.               gint      vertical,
  670.               gint      horizontal);
  671.  
  672. /* set/get selectable flag of a single row */
  673. void gtk_clist_set_selectable (GtkCList *clist,
  674.                    gint      row,
  675.                    gboolean  selectable);
  676. gboolean gtk_clist_get_selectable (GtkCList *clist,
  677.                    gint      row);
  678.  
  679. /* prepend/append returns the index of the row you just added,
  680.  * making it easier to append and modify a row
  681.  */
  682. gint gtk_clist_prepend (GtkCList    *clist,
  683.                 gchar       *text[]);
  684. gint gtk_clist_append  (GtkCList    *clist,
  685.             gchar       *text[]);
  686.  
  687. /* inserts a row at index row and returns the row where it was
  688.  * actually inserted (may be different from "row" in auto_sort mode)
  689.  */
  690. gint gtk_clist_insert (GtkCList    *clist,
  691.                gint         row,
  692.                gchar       *text[]);
  693.  
  694. /* removes row at index row */
  695. void gtk_clist_remove (GtkCList *clist,
  696.                gint      row);
  697.  
  698. /* sets a arbitrary data pointer for a given row */
  699. void gtk_clist_set_row_data (GtkCList *clist,
  700.                  gint      row,
  701.                  gpointer  data);
  702.  
  703. /* sets a data pointer for a given row with destroy notification */
  704. void gtk_clist_set_row_data_full (GtkCList         *clist,
  705.                       gint              row,
  706.                       gpointer          data,
  707.                   GtkDestroyNotify  destroy);
  708.  
  709. /* returns the data set for a row */
  710. gpointer gtk_clist_get_row_data (GtkCList *clist,
  711.                  gint      row);
  712.  
  713. /* givin a data pointer, find the first (and hopefully only!)
  714.  * row that points to that data, or -1 if none do
  715.  */
  716. gint gtk_clist_find_row_from_data (GtkCList *clist,
  717.                    gpointer  data);
  718.  
  719. /* force selection of a row */
  720. void gtk_clist_select_row (GtkCList *clist,
  721.                gint      row,
  722.                gint      column);
  723.  
  724. /* force unselection of a row */
  725. void gtk_clist_unselect_row (GtkCList *clist,
  726.                  gint      row,
  727.                  gint      column);
  728.  
  729. /* undo the last select/unselect operation */
  730. void gtk_clist_undo_selection (GtkCList *clist);
  731.  
  732. /* clear the entire list -- this is much faster than removing
  733.  * each item with gtk_clist_remove
  734.  */
  735. void gtk_clist_clear (GtkCList *clist);
  736.  
  737. /* return the row column corresponding to the x and y coordinates,
  738.  * the returned values are only valid if the x and y coordinates
  739.  * are respectively to a window == clist->clist_window
  740.  */
  741. gint gtk_clist_get_selection_info (GtkCList *clist,
  742.                         gint      x,
  743.                         gint      y,
  744.                         gint     *row,
  745.                         gint     *column);
  746.  
  747. /* in multiple or extended mode, select all rows */
  748. void gtk_clist_select_all (GtkCList *clist);
  749.  
  750. /* in all modes except browse mode, deselect all rows */
  751. void gtk_clist_unselect_all (GtkCList *clist);
  752.  
  753. /* swap the position of two rows */
  754. void gtk_clist_swap_rows (GtkCList *clist,
  755.               gint      row1,
  756.               gint      row2);
  757.  
  758. /* move row from source_row position to dest_row position */
  759. void gtk_clist_row_move (GtkCList *clist,
  760.              gint      source_row,
  761.              gint      dest_row);
  762.  
  763. /* sets a compare function different to the default */
  764. void gtk_clist_set_compare_func (GtkCList            *clist,
  765.                  GtkCListCompareFunc  cmp_func);
  766.  
  767. /* the column to sort by */
  768. void gtk_clist_set_sort_column (GtkCList *clist,
  769.                 gint      column);
  770.  
  771. /* how to sort : ascending or descending */
  772. void gtk_clist_set_sort_type (GtkCList    *clist,
  773.                   GtkSortType  sort_type);
  774.  
  775. /* sort the list with the current compare function */
  776. void gtk_clist_sort (GtkCList *clist);
  777.  
  778. /* Automatically sort upon insertion */
  779. void gtk_clist_set_auto_sort (GtkCList *clist,
  780.                   gboolean  auto_sort);
  781.  
  782. /* Private function for clist, ctree */
  783.  
  784. PangoLayout *_gtk_clist_create_cell_layout (GtkCList       *clist,
  785.                         GtkCListRow    *clist_row,
  786.                         gint            column);
  787.  
  788.  
  789. G_END_DECLS
  790.  
  791.  
  792. #endif                /* __GTK_CLIST_H__ */
  793.  
  794. #endif /* GTK_DISABLE_DEPRECATED */
  795.